Allows your component to set the A5 world for a connection.

void SetComponentInstanceA5 (
    ComponentInstance aComponentInstance, 
    SInt32 theA5
);

Parameter descriptions

aComponentInstance

The connection for which to set the A5 world. The Component Manager provides a component instance to your component when the connection is opened. You can use a component identifier here, but you must coerce the data type appropriately.

theA5

The value of the A5 register for the connection.

DISCUSSION

Once you set the A5 world for a connection, the Component Manager automatically switches the contents of the A5 register when your component receives a request over that connection. When your component returns to the Component Manager, the Component Manager restores your client’s A5 value.

If your component has been registered globally and you have not set an A5 value, the A5 register is set to 0. In this case you should set the A5 world of your component instance to your client’s A5 value by using this function.

In general, your component uses this function only if it is registered globally; in this case, it typically calls this function when processing the open request for a new connection.

AVAILABILITY

Not supported in Carbon. Not available in Carbon.

CARBON NOTES

Because there is no A5 world in Carbon, you cannot use the functions GetComponentInstanceA5 and SetComponentInstanceA5 to access A5 information.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)